home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_MAN / IMP_VPRO.MAN < prev    next >
Encoding:
Text File  |  1996-06-13  |  9.6 KB  |  261 lines
  1.  
  2.  
  3. Import-VistaPro()          Unix Programmer's Manual          Import-VistaPro()
  4.  
  5.  
  6. NAME
  7.      imp_VistaPro - Vistapro Digital Elevation  Model  (DEM)  geometry  import
  8.      filter
  9.  
  10. SYNOPSIS
  11.  
  12.      This man page describes the options specific to the Vistapro DEM geometry
  13.      import converter.
  14.  
  15. EXAMPLE CONVERSION SYNTAX
  16.  
  17.      To convert a Vistapro DEM file to 3D Studio using the default  parameters
  18.      listed in the setup.ini file:
  19.  
  20.           pt -i vpro -o 3ds filename.dem
  21.  
  22.      To convert a Vistapro DEM file to VRML and override some of  the  default
  23.      options in setup.ini:
  24.  
  25.           pt -i vpro -in-vpro-skip-factor = 6 -o vrml filename.dem
  26.  
  27. OVERVIEW
  28.  
  29.      This geometry import converter imports, manipulates and converts  digital
  30.      elevation model (DEM) data in the Vistapro format.
  31.  
  32. FEATURES OF THIS CONVERTER
  33.  
  34.      Vistapro DEM datasets  typically  contain  60000  or  more  quadrilateral
  35.      polygons, or 1200000 triangles (for a 258x258 resolution sample). This is
  36.      an enormous number of polygons for most 3d rendering programs so this DEM
  37.      converter incorporates two unique options to overcome this problem:
  38.  
  39.           1) The converter can skip over samples in the dataset so  that  only
  40.           every  n-th  sample  is used. Rather than importing 258x258 samples,
  41.           the converter imports 51x51 samples (for a skip factor of  5)  which
  42.           results in only 2601 quadrilateral polygons.
  43.  
  44.           2) Rather than store the entire DEM dataset in  single  object,  the
  45.           DEM  converter breaks up the data into multiple smaller objects with
  46.           a common parent. This  has  shown  to  be  an  effective  method  to
  47.           speeding  up the wireframe redraws of the DEM data (by a factor of 2
  48.           or 3), and makes interactive user  movement  of  a  3d  camera  much
  49.           faster  since  each  sub-object  is only a few hundred polygons.  In
  50.           addition,  certain  rendering  programs  (such  as  Okino's   NuGraf
  51.           renderer)  use  much  less memory when many smaller objects are used
  52.           rather than one large object with many  polygons.  By  default  each
  53.           sub-object  stores  a  maximum  of  900 polygons; contrast this with
  54.           other converters which lump  all  120,000  polygons  into  a  single
  55.           object - few renderers will be able to render such a large object.
  56.  
  57.           3) A default 3d camera is added to the scene  which  views  the  DEM
  58.           data from a pleasing angle.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                              1
  65.  
  66.  
  67.  
  68. Import-VistaPro()          Unix Programmer's Manual          Import-VistaPro()
  69.  
  70.  
  71.           4) u/v texture coordinates are added to the imported data so that  a
  72.           bitmap image can be easily draped over the DEM data.
  73.  
  74.           5) The converter creates smoothed vertex normals for the DEM data so
  75.           that it will appear to be smooth when rendered.
  76.  
  77. COMMAND LINE OPTIONS
  78.  
  79.      The following options are specific to this import converter:
  80.  
  81.      -i vpro
  82.           This is the optional command line option which  specifies  that  the
  83.           input data is in the Vistapro DEM file format. If not specified then
  84.           the converter will try to guess the input  file's  format  from  its
  85.           file extension (.dem) and then from the contents of its file.
  86.  
  87.      -in-vpro-print-statistics = [ yes | no ]
  88.           If set to 'yes' then the converter will  print  out  the  number  of
  89.           objects and polygons created.
  90.  
  91.      -in-vpro-add-default-camera = [ yes | no ]
  92.           If set to 'yes' then the converter will add a default camera to  the
  93.           scene which views the DEM data at a pleasing angle.
  94.  
  95.      -in-vpro-skip-factor = #
  96.           This switch determines the quality of  the  imported  DEM  data  (it
  97.           directly  controls how many polygons will be used to approximate the
  98.           input DEM data). THIS IS AN IMPORTANT CONTROL PARAMETER!! A value of
  99.           1  results in the highest quality mesh while higher values (2, 3, 4,
  100.           etc) result in lower quality, but at the  benefit  of  reducing  the
  101.           number  of  polygons  in  the input data. This number will cause the
  102.           converter to 'skip' over every n-th input sample.  For  example,  if
  103.           the  input  dataset  size is 258x258 samples, and the skip factor is
  104.           set to 4, then the converter will actually read in the data as if it
  105.           were  of  size  65x65  (258/4 = 65). This will produce 4225 polygons
  106.           (65x65) instead of 66565 polygons. A value of 2 or 3 (16641 polygons
  107.           to  7396  polygons) will produce good results for a final rendering,
  108.           while values of 5 to 8 will produce small datasets  ideal  for  fast
  109.           previews (2704 polygons to 1024 polygons).
  110.  
  111.      -in-vpro-sub-grid-size = #
  112.           By default the DEM data will be cut up  into  several  smaller  sub-
  113.           objects rather than having all of the DEM data clumped together into
  114.           one huge object. This option controls how many polygons will be  put
  115.           into  each  sub-object.  The  default  is  30  which  will cause 900
  116.           polygons (30x30) to be stored in each sub-object. The valid range is
  117.           5 to 100.
  118.  
  119.      -in-vpro-height-scaling-factor = #
  120.           This option scales the height of the DEM data. It  default  to  1.0.
  121.           Values  greater  than 1.0 will make the DEM data higher while values
  122.           between 0.0 and 1.0 will make the DEM data shorter.
  123.  
  124.      -in-vpro-add-2d-txtr-coords = [ yes | no ]
  125.           If set to 'yes' then u/v texture coordinates will be  added  to  the
  126.           imported  dataset.  These texture coordinates will allow a 2d bitmap
  127.  
  128.  
  129.                                                                              2
  130.  
  131.  
  132.  
  133. Import-VistaPro()          Unix Programmer's Manual          Import-VistaPro()
  134.  
  135.  
  136.           image to be easily mapped to the surface of the  data.  Please  note
  137.           that  the  texture  coordinates  are  aligned  with the mathematical
  138.           bounding quadrilateral of the dataset, not the actual physical edges
  139.           of  the data (this is because the physical edges of the data are not
  140.           square or precise).
  141.  
  142.      -in-vpro-add-default-2d-texture = [ yes | no ]
  143.           If  set  to  'yes'  then  a   default   2d   bitmap   texture   file
  144.           ("default.tif")  will  be  linked  to  the  DEM data. This option is
  145.           useful if you intend to apply a 2d bitmap image to the DEM data. The
  146.           "-in-vpro-add-2d-txtr-coords" option must also be enabled.
  147.  
  148.      -in-vpro-texture-2d-u-repeat = 5
  149.  
  150.      -in-vpro-texture-2d-v-repeat = 5
  151.           These two values determine how many times the 2d bitmap  texture  is
  152.           to  repeat  across  the  DEM  data  surface  (see the "-in-vpro-add-
  153.           default-2d-texture" option above). The default values  are  5  which
  154.           will  make the texture repeat 5 times in the horizontal and vertical
  155.           directions.
  156.  
  157.      -in-vpro-add-default-3d-texture = [ yes | no ]
  158.           If  set  to  'yes'  then  a  NuGraf  "mountain"  procedural  texture
  159.           definition  will  be  added to the scene and assigned to the current
  160.           shader (useful for rendering the DEM data with the NuGraf renderer).
  161.           This  texture  varies  the  color  of  the DEM data according to the
  162.           elevation and slope of a polygon (the color varies from  greens,  to
  163.           browns  to  whites at the highest altitudes).  Please note that this
  164.           texture tends to be slow to  compute  due  to  the  turbulence  math
  165.           functions;  a  better  alternative  would  be  to assign a 2d bitmap
  166.           texture.
  167.  
  168.      -in-vpro-create-one-object = [ yes | no ]
  169.           If set to 'yes' then one single object is created  for  all  of  the
  170.           imported  data  rather  than having the data broken up into multiple
  171.           smaller sub-objects (the default). The converter automatically  sets
  172.           this to 'yes' (internally) if the selected output format is to be 3D
  173.           Studio (this is because 3D Studio requires all polygons to be inside
  174.           a  single object so that its smoothing algorithm will work properly;
  175.           if multiple objects are used then the vertex normals will not be the
  176.           same where the sub-objects meet and hence "cracks" may appear at the
  177.           junctions).
  178.  
  179.      -in-vpro-triangulate-data = [ yes | no ]
  180.           If set to 'yes' then the DEM data  will  be  imported  as  triangles
  181.           instead  of  4  sided  polygons.  This is sometimes useful to enable
  182.           since 4-sided DEM data polygons are not planar.
  183.  
  184. LIMITATIONS
  185.  
  186.      If exporting to 3D Studio then all of the DEM data must  be  exported  as
  187.      one  object  so  that  proper smoothing occurs between the sub-chunks. 3D
  188.      Studio has a limit of 64k vertices and 64k polygons, therefore the  chunk
  189.      size  must  be  set  appropriately  to  limit  the number of polygons and
  190.      vertices output (the number  of  polygons  created  can  be  verified  by
  191.      setting the '-in-vpro-print-statistics' option to 'yes' and checking that
  192.  
  193.  
  194.                                                                              3
  195.  
  196.  
  197.  
  198. Import-VistaPro()          Unix Programmer's Manual          Import-VistaPro()
  199.  
  200.  
  201.      the number of polygons created is less than 65536).
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                                                              4
  260.  
  261.